home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 3 / ct-rom iiib.zip / ct-rom iiib / OS2 / PROGRAM / GBASE211 / README.1ST < prev   
Text File  |  1994-04-25  |  12KB  |  297 lines
  1.  
  2.  
  3. Guidelines Version 2.1A                               26th April 1994
  4. ───────────────────────                               ───────────────
  5.  
  6. Graphical User Interface Editor and Application Generator for Personal
  7. Computers running IBM's OS/2 Version 2.1 or higher.
  8.  
  9. JBA reserves the right to change the function and design of the
  10. Guidelines product without prior notice. 
  11.  
  12.  
  13. Copyright Notice
  14. ────────────────
  15.  
  16. Copyright in the software contained on these diskettes or in these 
  17. files referred to by its product name "GUIDELINES", ("the Software") 
  18. is the exclusive property of JBA International plc.
  19.  
  20. The User is licensed to use the Software subject to accepting and
  21. complying with the following conditions.
  22.  
  23. 1.  It may only be used by the party ("the User") to whom JBA have
  24.     directly supplied the Software.
  25.  
  26. 2.  The User shall only use the Software on one processor and no part
  27.     of it shall be reproduced or loaded into, transmitted to or used on
  28.     any other processor.
  29.  
  30. 3.  This licence is personal to the User who shall not assign or
  31.     transfer any interest in it or grant any right under it to any third
  32.     party or part with possession of the diskettes or any other
  33.     media on which the Software is stored without the prior written
  34.     consent of JBA.
  35.  
  36. 4.  Information necessary to achieve interoperability of the Software
  37.     with other programs within the meaning of Section 50B of the
  38.     Copyright, Designs and Patents Act 1988 and the Directive of the
  39.     Council of the European Communities on the Legal Protection of
  40.     Computer Programs is available from JBA - Reference JKJ/1810,
  41.     (UK) telephone number +44 (0) 527 854525.
  42.  
  43.  
  44. Getting Started
  45. ───────────────
  46.  
  47. [If you have a previous version of Guidelines installed on your machine, see 
  48. the "Migration Considerations" section below before continuing.]
  49.  
  50. If you have the electronically distributed version of Guidelines, you can 
  51. either:
  52.  
  53.  1. Create 3 diskettes by unzipping each of the files onto a separate 
  54.     diskette, or
  55.  
  56.  2. Unzip the contents of all three files into a directory on your hard 
  57.     drive, and perform the installation from there.
  58.  
  59. If you have created three diskettes or received the diskettes as manufactured
  60. by JBA, to install Guidelines insert the first installation disk (made from 
  61. GBASE1.ZIP) into your floppy drive.
  62.  
  63. Type:
  64.  
  65.       [X]:\install
  66.  
  67. where [X] is the drive you are installing from, e.g. "a:\install". Include
  68. the directory name if you are installing from a directory on the hard drive.
  69.  
  70. Press ENTER and the install program will start and display an initial
  71. banner dialog. Press the OK button (or ENTER) and you may then begin
  72. selecting options from the installation menu.
  73.  
  74.  
  75. Selecting The Install Path
  76. ──────────────────────────
  77.  
  78. From the installation menu, selecting the 'Directories...' menu option which
  79. will display a dialog providing the ability to modify the directories in
  80. which Guidelines will be installed. The source directory will default to the
  81. path from where the installation program was run and the target directory
  82. will default to [Y]:\GUIDE (where [Y] is your boot drive).
  83.  
  84. If you want to install Guidelines in another directory (or on another
  85. drive), modify the target directory to the path required. The installation
  86. program will ask you if you wish to create the directory when the target
  87. directory does not already exist.
  88.  
  89. If the nominated directory already contains an existing copy of Guidelines,
  90. the installation program will prompt you to confirm the over writing of
  91. the Guidelines system files. Note that any existing user GUI files within 
  92. the old Guidelines directory will not be destroyed or modified.
  93.  
  94.  
  95. Installation Options
  96. ────────────────────
  97.  
  98. When Guidelines finishes installing the software, it will automatically 
  99. create a Workplace Shell folder for the software (this is the default).
  100. If you wish, this may be prevented by unchecking the 'Create WPS Folder'
  101. option.
  102.  
  103. You may also optionally prevent the automatic updating of the CONFIG.SYS
  104. from this dialog. Guidelines requires LIBPATH and various environment
  105. settings to be set correctly before it can be run. If you are installing
  106. over an old copy of Guidelines, you may wish to turn this feature off.
  107. You can also optionally select that the changes which would normally be
  108. made to CONFIG.SYS be written to a separate file (created in the target
  109. directory) which you can then apply yourself after running the install 
  110. program.
  111.  
  112.  
  113. Installing
  114. ──────────
  115.  
  116. Once you have selected an installation directory and set the appropriate
  117. install options, you should select the 'Install...' menu item from the 
  118. 'Install' submenu to begin the install. Before the files are actually copied 
  119. to disk, a registration dialog will be presented which allows you to 
  120. personally customize your copy of Guidelines. Enter your name and company 
  121. (if applicable) and your registration number (if you are a registered user). 
  122.  
  123. For non-registered users, a blank registration number will enable 
  124. full-functionality for the base product only. Once these details are 
  125. entered, and the OK (or ENTER key) is pressed, a status dialog is displayed 
  126. which will show the install status as the files are copied to disk.
  127.  
  128. Once the installation is complete, you may need to reboot your machine
  129. so that any CONFIG.SYS file changes can take effect. The install program will
  130. notify you if this is required (i.e. if changes have been made to the
  131. CONFIG.SYS file).
  132.  
  133.  
  134. Installing Extensions
  135. ─────────────────────
  136.  
  137. Guidelines control packs may be installed via the 'Install Extensions...'
  138. menu item. Extension packs are separately available on their own
  139. disks. To install an extension, you should set the appropriate directories
  140. and install options in the same manner as for the base Guidelines product.
  141.  
  142.  
  143. Running Guidelines
  144. ──────────────────
  145.  
  146. After a successful installation you may invoke Guidelines by typing "Guide"
  147. and pressing the Enter key at a command prompt, or via the WorkPlace
  148. object created (optionally) during the install.
  149.  
  150. If you are new to Guidelines, a "Getting Started" online document and tutorial
  151. may be found in the Documentation folder (if installed) or readable as
  152. GETSTART.INF in the DOC directory (using VIEW.EXE).
  153.  
  154. If you are a user of an previous version of Guidelines, a "New Features"
  155. online document describes what has been added in the 2.1A release. This
  156. may also be found in the Documentation folder (if installed) or readable as
  157. NEWFEAT.INF in the DOC directory (using VIEW.EXE).
  158.  
  159.  
  160. Migration Considerations
  161. ────────────────────────
  162.  
  163. If you have a previous version of Guidelines installed on your machine, it 
  164. is recommended that you do not install the current release over it. This is 
  165. because the files in previous versions may not have counterparts in the 
  166. current release, and might not be erased or overwritten by a new installation.
  167. Also, the directory structure has changed slightly from previous releases.
  168.  
  169. In this case, you might rename the existing top level directory, install to 
  170. a new directory with a different name, or delete the previous version before 
  171. installing. Should you use either of the first two approaches, you can then 
  172. move or copy your GUI project files to the new GUI directory, and convert 
  173. them to the new format.
  174.  
  175. It is recommended that you make certain you have updated versions of all the
  176. Guidelines Controls and Extensions which you use in your projects before 
  177. replacing your current setup. Older versions of the controls are not 
  178. compatible with the current release. As a registered customer, you will be
  179. automatically sent the updates, free of charge by JBA.
  180.  
  181. GUI files created with previous versions of Guidelines can be converted to 
  182. work with the current release in two ways.
  183.  
  184.  1.  The install program can convert a number of files, either at install 
  185.      time or later.
  186.  
  187.  2.  Guidelines itself will perform a conversion on individual files as they 
  188.      are loaded into the editor.
  189.  
  190. Conversion is a one way process, and once converted, the GUI files will not 
  191. be readable by earlier versions of Guidelines.
  192.  
  193. Guidelines is generally upward compatible with its predecessors, but in 
  194. this release the DestroyThread() function has been removed (see the "New 
  195. Features" document for details). You will therefore need to rework code 
  196. which contains this function.
  197.  
  198.  
  199. System Requirements
  200. ───────────────────
  201.  
  202. Guidelines requires that you have OS/2 Version 2.1 or higher already
  203. installed on your computer. For information about setting up OS/2 on your
  204. computer, see the instructions in your OS/2 package.
  205.  
  206. The minimum hardware requirements for running Guidelines are the same
  207. as the normal OS/2 requirements. However the recommended configuration
  208. for Guidelines development are as follows:
  209.  
  210.     ■ Numeric coprocessor
  211.     ■ 15" or greater display monitor
  212.     ■ 8514, SVGA or XGA graphics adapter running at 1024x768 resolution
  213.     ■ 16MB of memory
  214.     ■ 30MB of available swap space
  215.  
  216. These are the recommendations for using the IBM C Set++ compiler, and may be
  217. reduced if you will be using a different vendors tools.
  218.  
  219. Guidelines assumes that you have a supported C++ compiler and the OS/2
  220. Toolkit installed on your hard drive. While applications can be designed
  221. without the C++ compiler, the source code generated cannot be compiled
  222. into an executable unless a compiler is present.
  223.  
  224. Currently supported compilers are:
  225.  
  226. 1. For OS/2 Development
  227.    ────────────────────
  228.  
  229.     Borland C++ for OS/2 V1.01
  230.     IBM CSet++ V2.1
  231.     Watcom C++ V9.5
  232.  
  233. 1. For Windows Development
  234.    ───────────────────────
  235.  
  236.     Borland C++ V3.1 for DOS/Windows
  237.  
  238.  
  239. Guidelines Support
  240. ──────────────────
  241.  
  242. If you have problems installing this copy of Guidelines, or require
  243. additional information about Guidelines, contact Guidelines Support
  244. using one of the following means:
  245.  
  246. 1. CompuServe
  247.    ──────────
  248.  
  249.    Support is available in the OS2AVEN forum, Section 1 (Other Vendors).
  250.    Address enquiries to "Guidelines Support" at 100316,3353
  251.  
  252.    Mail from the Internet may also be sent to the above account using the
  253.    address 100316.3353@compuserve.com
  254.  
  255.  
  256. 2. JBA Direct
  257.    ──────────
  258.  
  259.  JBA may be contacted by telephone for Guidelines enquiries at the following 
  260.  offices:
  261.  
  262.         Africa:                +27 11 804 5062
  263.         Australasia:             To be advised
  264.         Europe (UK):              081 899 5600
  265.         North America;            416 940 2442
  266.  
  267.  
  268. Purchasing Guidelines and Guidelines enquiries
  269. ──────────────────────────────────────────────
  270.  
  271. Copies of Guidelines, additional licences, extension packs and
  272. image packs may be purchased using one of the following means:
  273.  
  274. 1. CompuServe
  275.    ──────────
  276.  
  277.    Address orders and order enquiries to:
  278.  
  279.         "Guidelines Purchase" at 73022,35
  280.             (73022.35@compuserve.com)
  281.  
  282.  
  283. 2. JBA Direct
  284.    ──────────
  285.  
  286.    Send FAX to "Guidelines Purchase" on:
  287.  
  288.         Birmingham, UK:             +44 (0)21 753 1559
  289.  
  290. ───────────────────────────────────────────────────────────────────────
  291.  
  292. *   IBM, C Set++, Operating System/2, OS/2 and Presentation Manager are
  293.     trademarks or registered trademarks of International Business
  294.     Machines Corporation. Borland C++ is a trademark of Borland 
  295.     International, inc, and Watcom is a trademark of Watcom International 
  296.     Corporation.
  297.